home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / duchie.arc / 291USDOC.EXE / pak / DU291DUS.ASC < prev   
Text File  |  1990-06-14  |  23KB  |  614 lines

  1. Contents
  2. --------
  3.  
  4. GENERAL
  5.  
  6.   1. Introduction
  7.  
  8. POINT MANUAL
  9.   
  10.   2. Point Installation
  11.   3. What Install did to your system
  12.   4. Checking the installation 
  13.   5. Connecting to your BOSS 
  14.   6. Reading and entering messages
  15.   7. Joining electronic conferences
  16.   8. In and Exporting conference messages
  17.   9. Using dutchie to connect to a Bulletin Board
  18.  10. Scripts
  19.  11. Adding a namelist
  20.  12. Carbon copies and mailing lists
  21.  13. MSG, REQ and XMIT
  22.  14. Automating DCM
  23.  15. Where is your mail going, routing and such
  24.  15. What to read next
  25.  16. I want more ! A pointplus system
  26.  17. Nodelist maintenance
  27.  18. More reading
  28.    
  29. BOSS/MAILER MANUAL
  30.  
  31.  19. Mailer Installation
  32.  20. Nodelists and such
  33.  21. Events
  34.  22. Routing and forwarding
  35.  23. Level and keys
  36.  24. Setting up filerequest support 
  37.  25. Allowing filerequests
  38.  26. The request response file
  39.  27. Request translations
  40.  28. Setting up service requests
  41.  29. Banner file
  42.  30. Running under a multitasker
  43.  31. Allow access to a Bulletin Board
  44.  32. Example batch and configuration files
  45.  33. Control files, control files
  46.  34. Setting up conferences
  47.  35. More reading
  48.  
  49.  
  50.  
  51. EDITER USER MANUAL
  52.  
  53.  35. Starting the editor
  54.  36. Reading messages
  55.  37. Creating a message
  56.  38. Replying to a message
  57.  39. Name- and Filelists
  58.  40. File attaches
  59.  41. File, Update and service requests
  60.  42. The message flagbits
  61.  43. The message editor
  62.  44. About kludge lines
  63.  45. Macros
  64.  46. saving/printing a message
  65.  47. Maintenance
  66.  49. Moving and forwarding messages
  67.  50. Changing a message and its culprits
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74. MAILER USER MANUAL
  75.  
  76.  51. Starting the mailer. Commandline options
  77.  52. Attended mode
  78.  53. Unattended mode
  79.  54. Terminal mode
  80.  
  81.  
  82. DCM USERMANUAL
  83.  
  84.  55. Starting DCM
  85.  56. Importing confrences and its options
  86.  57. Exporting conferences and its options
  87.  58. Conference Maintenance
  88.  59. Join, DisJoin and Areas support
  89.  60. Report functions
  90.  61. Split packet point support
  91.  62. Other options
  92.  
  93.  
  94. DUTMAIN USER MANUAL
  95.  
  96.  63. Starting Dutmain
  97.  64. nodelist maintenance
  98.  65. Namelist maintenance
  99.  
  100.  
  101. DUTCHCOM USER MANUAL
  102.  
  103.  64. Starting Dutchcom
  104.  65. Fidonet Nodelists
  105.  66. Update lists
  106.  67. DUTCHLAT
  107.  68. Dumping the lists
  108.  69. smart compiling
  109.  
  110. REQ, MSG AND XMIT
  111.  
  112.  70. REQ, the commandline requester
  113.  71. MSG, automated distribution of messages
  114.  72. XMIT, automated distribution of files
  115.  
  116.  
  117. SCRIPTS AND THE SCRIPT PROCESSOR
  118.  
  119.  73. Scripts
  120.  74. Dutchies script language
  121.  75. enabling scripts
  122.  76. Script examples
  123.  
  124. SETTING UP A NETWORK
  125.  
  126.  77. Name convention.
  127.  78. Simple Boss + points
  128.  79. Adding a level, Nodes and HOST
  129.  80. A big net with routing Hubs
  130.  81. Adding one more level, zones
  131.  82. Connection to other networks, like UUCP, BITNET and such
  132.  
  133. INSTALLING SPECIAL MODEMS
  134.  
  135.  83. The modem file detailed
  136.  84. testing with DUTCHIE X+
  137.  
  138.  
  139.  
  140. TECHNICAL STUFF
  141.  
  142.  85. Protocol standards
  143.  86. File standards
  144.  
  145.  
  146.  
  147.  
  148. Introduction
  149. ------------
  150.  
  151. Dutchie is a complete Personal Mailer System that allows you to
  152. do sophisticated electronic communication with inividuals or
  153. groups of people using standard low cost telephonelines. Dutchie
  154. is a complete packet and does not need any other program to
  155. perform its duties. It is designed to be user friendly and easy
  156. to install and use.
  157.  
  158. Basically Dutchie enables you to pass messages and files to and
  159. request messages and files from other persons or systems without
  160. having to know the technical details of datacommunication.
  161.  
  162. In short, if you want to
  163.  
  164. o    exchange electronic messages with others
  165. o    make files available with extensive security
  166. o    want to start electronic conferences (also called special
  167.      interest  groups or echomail)
  168. o    want to distribute reports, files or updates scheduled or
  169.      unscheduled
  170.  
  171. and more, than Dutchie will be af great use to U.
  172.  
  173.  
  174. About this manual
  175. -----------------
  176.  
  177.  
  178. There are basically two classes of users of dutchie. Those that
  179. use Dutchie as a mailing tool to access system to get services
  180. (or get the services delevered at there doormat by the remote
  181. Dutchie) and users that provide services. The first type of users
  182. are called POINTS (off a system), the second type of users are
  183. called BOSSES. There exists intermediate type of users, so called
  184. POINTPLUS systems (that are points with more features) and
  185. MAILERS (that are BOSSES with less features). The manual is
  186. devided into three parts, the POINT part, the BOSS part and the
  187. technical reference stuff. Because a BOSS must be able to help
  188. out the points he services a potential BOSS user should read the
  189. point manual and install a point to get aquintant with the
  190. software. If you are responsible for setting up a private net
  191. outside other networks then read the chapter 'Setting up a
  192. network' now, and return here after that.
  193.  
  194.  
  195.  
  196. POINT(PLUS) MANUAL
  197. ==================
  198.  
  199.  
  200. Point Installation
  201. -------------------
  202.  
  203. Most people don't want to read manuals, but start with the
  204. installation right away out of the box. That's why we have
  205. included the installation chapter here, right at the beginning.
  206. However, your Dutchie software cannot be used standalone like a
  207. wordprocessor. Dutchie is ment for communication, thus you need
  208. at least one other Dutchie system to communicate with. And that
  209. implies that some coordination is needed. As Dutchie is used in
  210. world wide networks with thousants of users, some adressing is
  211. needed to get the message on the system where you want it. The
  212. installation program will ask you about the adress you have in
  213. the network and YOU CANNOT DECIDE THAT ON YOUR OWN. In a network
  214. one person or administrative organisation is responsible for
  215. handing out adresses so yoiur address will be unique. If you are
  216. going to join the public fidonet via a BOSS you should ask your
  217. BOSS for these adresses. If you are going to join a network, the
  218. networks coordinator will assign adresses.
  219. For netcoordinators forming their own net, see the chapter on
  220. building networks with dutchie in the BOSS section.
  221.  
  222. Before you start the installation, here is a list of checkpoints.
  223. Please make sure you have all information available and have all
  224. data checked, the installation itself is a question of minutes.
  225.  
  226.  
  227. 1. System requirements
  228.  
  229.      Your system should be an IBM PC, XT, AT or PS/2 or close
  230.      compatible with atv least 512 k of RAM memory and a hard
  231.      disk. Dutchie will run on a floppy based system but we do
  232.      not recommend it.
  233.  
  234. 2. Modem requirements
  235.  
  236.      Dutchie knows how to control the modem from a modem command
  237.      file that contains the modem commands for the modem
  238.      concerned. The installation program supports more than 50
  239.      modems directly and has their commandfiles available.
  240.      Dutchie (by its design) will run with almost any intelligent
  241.      modem, Hayes compatible or not, but making a commandfile and
  242.      testing it for an unsupported non hayes modem can be a task
  243.      of several hours. Thus a Hayes compatible modem is highly
  244.      recommended. If a Hayes compatible modem is not directly
  245.      supported, then choose the USR COURIER modem, in almost
  246.      all cases that one will work.
  247.      Please write down your modems brand and type and the
  248.      comport it uses. Make sure the modem is installed properly
  249.      (if internal) and the cable has al least 8 wires if the
  250.      modem is external. Most problems with a dutchie installation
  251.      are due to an incorrect modem installation, especially with
  252.      internal modems. We will give some testing advise after the
  253.      installation. Also be sure to TYPE the file DUTCHIE.MDM
  254.      after the installation is complete. It can contain valuable
  255.      information for switch settings on your modem and such.
  256. 3.   Additional information
  257.  
  258.      If you setup as a point or pointplus you should have
  259.      the following adress information available (get it from
  260.      the person responsible for the network):
  261.      Your Zone, Net, and Nodenumber .
  262.      Your Bosses zone, Node and net number
  263.      Your Bosses phonenumber
  264.      Your own phone number
  265.      Your Bosses maximum baudrate
  266.      An agreed sessionlevel password with your Boss
  267.      
  268.  
  269. Well, here we go. Insert Dutchies  distribution disk #1 in
  270. diskdrive A. Make the drive A current. Type INSTALL.
  271. You will have to answer a few questions now. There is some
  272. explanation at the top of the screen and if needed an example is
  273. displayed at the bottom of the screen. The first question is
  274. wheter this is a new installation or an update. We assume a new
  275. installation here, but remember, whenever you get update
  276. diskettes, the above procedure will get you here and choosing the
  277. U(pdate) option on this screen will update your existing dutchie
  278. installation. Choose N(ew) installation for now.
  279. The scond question is if you have a distribution set or all files
  280. are available in a directory. We assume a distribution set here
  281. (F). Next the installatiuon program will ask you some information
  282. about the place where Dutchie must be installed. Answer the
  283. questions, mostly it will be an harddisk C:.
  284. Well, that was easy enough. You are now staring at a screen full
  285. of questions that must be answered. Lets go through them one by
  286. one. (We assume a point installation here, Bosses and mailers
  287. will see some other questions. Please check the bottom row of the
  288. screen, some explanation is displayed there for every field.
  289.  
  290. Your systems name
  291.      Just enter a name you like, like 'My point of view' or such
  292. Your name
  293.      Your First name, followed by a space, followed by your last
  294.      name. Two names only please.
  295. Your phone number.
  296.      This is used to install your phonenumber at your Boss the
  297.      first time you call him. Therefor this number must be in
  298.      international form. See the bottom line.
  299. Your Zone
  300.      Got that from your Boss
  301. Your Net
  302.      NOTE: This is the so called POINTNET. Your Boss has supplied
  303.      this to you.
  304. Your Node
  305.      This is your POINT NUMBER
  306. Your Bosses zone, net and node
  307.      Got that didn't you ?
  308. Your Bosses phone
  309.      Enter the phonenumber exactly as you should dial it
  310.      manually.
  311.      Thus this is NOT in international form. Better check if
  312.      you get your bosses system when you dial the numbers you
  313.      entered here.
  314. Your Bosses maximum baudrate
  315.      Got that from your Boss. If you don't know ask. With
  316.      modern standard modems it will be 2400 or 9600.
  317. Session password.
  318.      Session level passwords protect your exchange with the other
  319.      system (for a point that is always the BOSS). It prevents
  320.      other systems pretending they are you and picking up your
  321.      mail. Once a password is installed systems that call in with
  322.      your address (=ID) with none or another password are
  323.      disconnected immediately. Bosses can run in two modes:
  324.      Secure and open. In secure mode they only accept systems
  325.      that have a password. In open mode they accept systems 
  326.      without a password and will install a password on the first
  327.      Call the other system uses a password. Once a password is
  328.      installed the connection will always need that password.
  329.      The bottomline is that when your Boss runs an open system
  330.      you can pick your password and it will installed the first
  331.      time you and your Boss connect. If your Boss runs secure,
  332.      then you need a password from him before you can start.
  333.      If the Boss forgot to install your passsword on his system
  334.      manually you will not be able to connect.
  335.  
  336. Poll Boss every night
  337.      When you want to let your system called your Boss every
  338. night
  339.      unattended to see if there is something new then answer yes
  340.      here.
  341.  
  342. Want mail printed
  343.      If yes, your new mail will be printed every night at a
  344.      predetermined time.
  345.  
  346. Start active mailslot at....
  347.      When you have told that you want your Boss to be polled
  348.      every night then this is the time (hh:mm) when dutchie
  349.      starts dialling
  350.  
  351. Stop active mailslot at
  352.      As above, the ending time. This is only important when the
  353.      connection has not been successfull. Dutchie will of course
  354.      stop dialing the Boss after the first successful connection
  355.  
  356. Modem connected to port
  357.      This should bve correct. 1, 2, 3 or 4
  358.  
  359. Print new mail at ....
  360.      When the mailprinting should start (after the end of the
  361.      poll slot of course.
  362.  
  363.  
  364. Ok, so far so good. use the cursorkeys to change some item when
  365. you see somthing is not correct. Hit F10 when all is ok.
  366.  
  367. You will now be asked about your modem. This is straight forward.
  368. As said, if your modem is not supported try the ROBOTICS COURIER.
  369. If it does not work, then contact us, we probably have the file
  370. for you.
  371.  
  372. Now the installation will proceed automatically. The Install
  373. program will ask for disk #2 if needed.
  374.  
  375. After a few minutes the installation is complete. DONE.
  376.  
  377.  
  378.  
  379. What install did
  380. ----------------
  381.  
  382. Install has created a few directories on your harddisk to keep
  383. the dutchie files. The base directory is \DUTCHIE where all the
  384. program and configuration files are kept. In addition you will
  385. see the directories \DUTCHIE\NETMSGS, \DUTCHIE\NETFILES and
  386. \DUTCHIE\OUTBOUND.
  387.  
  388. \DUTCHIE\NETMSGS is a placeholder for all electronic messages
  389. that you create or that people will send you. You access these
  390. via the message editor, called DUTCHED. If you make dutchies
  391. directory current and type DUTCHED you can read and write those
  392. electronic messages.
  393.  
  394. \DUTCHIE\NETFILES is a placeholder for all incoming files. These
  395. files come either on your system attached to an electronic
  396. message or via the terminal download option.
  397.  
  398. \DUTCHIE\OUTBOUND is a placeholder for so called mailbundles.
  399. before calling another system Dutchie bundles all outgoing
  400. messages into a mailbundle. This bundle will be placed in this
  401. directory. Normally this directory is of no concern to you.
  402.  
  403. Furthermore Install has placed several executable files in your
  404. Dutchie home directory. We will describe them later, but if you
  405. do a DIR *.EXE in dutchie directory you should at least see:
  406. DUTCHIE.EXE, DUTCHED.EXE, DUTZMDM.EXE, DCM.EXE, REQ.EXE, MSG.EXE,
  407. XMIT.EXE.
  408.  
  409. Now for the modemcontrol. Install should have checked if you have
  410. already installed X00.SYS, dutchies fast serial port driver. If
  411. you have not X00 on your system then Install should have placed
  412. X00.SYS in the basic root directory ( mostly C:\) PLEASE CHECK
  413. THIS. If this is not the case, locate X00.SYS and move it to your
  414. boot directory. Also Dutchie should have modified CONFIG.SYS to
  415. load the driver at startup. The line DEVICE=X00.SYS ...... should
  416. have been added to CONFIG.SYS. Please make sure this is the case.
  417. And when you are at it, the FILES and BUFFERS parameters in
  418. CONFIG.SYS should be large enough.
  419.  
  420. You should now REBOOT your system so X00.SYS will be loaded. This
  421. should be visible on your screen during startup.
  422.  
  423.  
  424. Checking out the installation
  425. -----------------------------
  426.  
  427. We are now ready for THE MOST IMPORTANT test, the modem
  428. connection and successfull installation of X00.SYS. Make Dutchies
  429. directory current (CD \DUTCHIE). Type DUTCHIE T+ followed by a
  430. RETURN (or ENTER). This will put Dutchie into a direct
  431. communication mode with your modem. Now type carefully AT
  432. followed by a RETURN. You should see OK. If that is the case,
  433. congratulations, no doubt Dutchie will perform ok with your
  434. setup. If you do not see OK, repeat typing AT followed by a
  435. RETURN a few times if possible. If you see garbage on the screen,
  436. try changing the baudrate to 1200 (by hitting F2 a few times).
  437. If that does not help, seek help. There is no way that we can
  438. help you without voice contact. There are a few pointers you
  439. could check before calling us or someone else:
  440. - Internal modems: Check IRQ number and PORT addresses. Is there
  441.   a mouse that conflicts with the modem ? Try removing the mouse.
  442. - external modems: are you sure you are connected to the right
  443.   SERIAL port ? Is the modem switched on ? Is the cable correct?
  444.   
  445. You can leave the terminal mode by hitting F1.
  446.  
  447.  
  448. Connecting to your BOSS
  449. -----------------------
  450.  
  451. Dutchie is a ver versatile set of programs. learning all possible
  452. options and fine tuning your system can take a while. However,
  453. the basic tasks are performed very easely. Here is how to 
  454. send your mail to your BOSS and to pick up the mail he has for
  455. you:
  456.  
  457. step 1:   Make dutchie directory current
  458. step 2:   Type DUTCHIE P+ A+ and hit ENTER
  459.  
  460. That is all there is to it. Dutchie will try to connect to your
  461. Boss and deliver/pickup the mail. It will show you on the screen
  462. what is going on and will return to DOS after a successfull
  463. connection, or after several attempts that failed.
  464.  
  465.  
  466. Entering and reading mesages
  467. ----------------------------
  468.  
  469. Starting the message reader/editor is also very easy:
  470.  
  471. step 1:   Make dutchies directory current
  472. step 2:   Type DUTCHED and then hit ENTER
  473.  
  474. The message editor/reader will be started. There is a whole
  475. chapter on the message editor, but for now a few hints will do:
  476.  
  477. reading messages: Use the left/right arraowkeys to move between
  478.                   messages and the PageUp/PageDown keys to read.
  479.                   Also the function keys displayed at the bottom
  480.                   are active.
  481.  
  482. entering messages: Hit F3. Then enter the persons name you wish
  483.                    to send the message to and hit ENTER. Now
  484.                    enter his address (zone:net/node.point or
  485.                    a shoprt form that will be discussed later)
  486.                    followed by ENTER.
  487.                    type the messages subject and hit ENTER.
  488.                    We leave the messagebits for what they are  
  489.                    now, just hit ENTER again. You are now in edit
  490.                    mode, like your wordprocessor, or editor. The
  491.                    standard control keys are supported and a menu
  492.                    driven interface is there. When you are done,
  493.                    hit SAVE. Thats all. Not too difficult eh ?
  494.                    The editor is pretty sophisticated with
  495.                    search/replace and block commands, but we
  496.                    leave that to another chapter.
  497.                          
  498. We have now a working communication system that will connect to
  499. your Boss. If you want unattended mailhandling in cheap nightly
  500. hours, the start the mailer with DUTCHIE B+. Dutchie will start
  501. up and go into waiting mode until the active event has come. It
  502. then will pack your mail and try to send it to your Boss. You can
  503. take the system down with F1 when you wake up in the morning. You
  504. do not have to be afraid of hackers or such. There is no way to
  505. get into your system via Dutchie in this setup.
  506.  
  507.  
  508. Joining electronic conferences
  509. ------------------------------
  510.  
  511.  
  512. To make the communication system fully operational. including
  513. electronic conferencing you need to install Dutchies Conference
  514. Manager DCM. If your Boss is Dutchie, its easy, let first find
  515. out what conferences are available:
  516.  
  517. Step 1: Make Dutchies directory current
  518. Step 2: Type REQ now .AREAS
  519.  
  520. Dutchie will dial out to your Boss and if your Boss has the
  521. standard Dutchie setup a file AREAS.REP will be sent to your
  522. system. Type this file and you will see what conferences are
  523. there available for you. Areas marked with a star (*) are not yet
  524. setup for your system. Lets choose 1 for the first try, you can
  525. repeat this later if all works ok. So JOINING a conference:
  526.  
  527. Step 1:   Make Dutchies directory Currenty
  528. Step 2:   Type REQ now .JOIN <areatag>
  529.  
  530. where <areatag> is the tag of the requested area (Dutchies
  531. international support area has the tag WINDMILL, you should
  532. probably start with this one if its available). Thus for WINDMILL
  533. the command is REQ NOW .JOIN WINDMILL. You will get a REQUEST.xx
  534. file back that will tell you if the JOIN is a success or if it
  535. failed. For later use, if your Boss is running Dutchie 2.91e or
  536. up, you can have more <areatags> after the .JOIN command. If you
  537. want to leave an electronic conferece, then use the above steps,
  538. but use the command .DISJOIN instead of .JOIN.
  539.  
  540. Ok, so now the BOSS knows that you want to JOIN an area and has
  541. acknowledged connection. What next. Nothing special. Just keep
  542. connecting to the Boss every day (if you are connected to an
  543. electronic conference you should connected every day to get your
  544. conference !). DCM on the Bosses system will instruct DCM on your
  545. system what to do. As soon as your DCM has followed instructions,
  546. you will see a message on your system when you start DUTCHED,
  547. that the confernece is now available on your system. This message
  548. is most likely followed by another message giving you the rules
  549. of the conference(s) and whatever the conference moderator sees
  550. fit to tell new conference attendees. How to read the conferences
  551. messages? Again, easy:
  552.  
  553. Step1: Start DUTCHED
  554. Step2: Hit ALT, keep down, Hit F9.
  555. Step3: Choose the conference number.
  556.  
  557. You can switch between conferences and the MAIL area by following
  558. the above three steps.
  559.  
  560.  
  561. Importing conference mail
  562. -------------------------
  563. For economical reasons conference messages arrive in a compressed
  564. form on your system (in the file area). To unpack the messages
  565. you should act as follows every time you received conference
  566. mail:
  567.  
  568. Step 1:  make Dutchies directory current
  569. Step 2:  type DCM -i and hit ENTER
  570.  
  571. Exporting your messages
  572.  
  573. If you have entered messages in one or more conferences, this
  574. messages must be exported and packed. To do that:
  575.  
  576. Step 1: make Dutchies directory current
  577. Step 2: type DCM -e and hit ENTER
  578.  
  579.  
  580. DCM has a lot more features and options. As with must programs
  581. from teh dutchies series, typing the programs name alone will
  582. show you the options. Also this process of in and exporting can
  583. be automated very easely by changing a little in dutchies
  584. configuration file. If you have mastered the above commands then
  585. go to the chapter 'More about conferencing' for more details.
  586.  
  587.  
  588.  
  589.  
  590. Mail versus conferences
  591. ------------------------
  592.  
  593. A few words about conferences and electronic mail. Although they
  594. look the same, there is a fundamental difference between the two.
  595. MAIL goes to one individul person. You need to know his address
  596. to send him mail. Other people (except system operators on the
  597. intermediate systems) cannot read the mail. CONFERNCE MESSAGES
  598. go to ALL connected systems. (some conferences can connect a few
  599. hunderd systems). That means that you should enter only messages
  600. that are of general interest to all participants in a conference.
  601. If you are starting a private discussion, move the discussion to
  602. the electronic mail area. That will keep the costs down and the
  603. conference interesting. Also, stick to the Conferences subjec.
  604.                     
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.      
  612.      
  613.  
  614.